This Table of Contents retains the original printed manual page numbering scheme. Special Tags have been added to allow instant Finding of all page references. Pull down the File menu and Choose Find, then enter the desired page number with asterisk characters preceding and following the number.
For example, *7* will Find several tags that reside within the text formerly on printed page 7 of the manual.
Introduction 1
Presentation Conventions 1
Chapter 1. Prograph: The Language 3
Overview 3
Classes 4
Editor Actions 5
Class Names 5
Attributes 5
Methods 6
Plain Method 7
Get Method 7
Set Method 7
Initialization Method 7
Methods 8
Universal Methods 8
Cases of Methods 8
Compact Code 9
Operations 9
Connectors 10
Datalinks 10
Synchro Links 10
Names of Operations 11
Prograph Operations 11
Simple 12
Constant 12
Match 13
Persistent 13
Instance 13
Get 14
Set 14
Super 15
Local 15
Evaluate 16
Name 16
Terminal 17
Root 17
Macintosh Toolbox Operations 17
Mac Method 17
Mac Constant, Mac Match, and Mac Global 17
Mac Get Field, Mac Set Field, and Mac Address 18
Multiplex Operations 18
Repeat 18
List 19
Loop 19
Partition 19
Controls 19
Success, Failure, and Error 20
Success 20
Failure 20
Error 20
The Controls 20
Next Case 21
Continue 21
Terminate 21
Finish 21
Fail 22
Inject 22
Persistents 23
Chapter 2. The Editor Environment 25
General Rules in the Editor 25
Launching Prograph Documents 25
Prograph Extensions Folder 26
When Prograph Is Launched 26
Creating Prograph Elements 27
Automatic Scrolling 28
Selection 28
Appearance 28
Click 28
Shift-Click 29
Marquee 29
Dragging 29
Nudging 29
Zoom and Shrink-Wrap 29
Editing Names 30
Linking/Unlinking 30
Opening 30
Commenting 30
Manipulation of Groups of Selected Elements 30
Combinations 31
Error Prevention 31
Menu Descriptions 31
General Features 31
The Apple Menu 32
About Prograph… 32
Switch Context 32
Enter Editor 32
The File Menu 32
New 33
Open… 33
Save 35
Save As… 35
New Text… 36
Open Text… 36
Save Text 37
Save Text As… 37
Page Setup… 37
Print… 37
The Edit Menu 40
Undo 40
Cut, Copy, Paste, Clear 40
Cut Object 41
Copy Object 41
Paste Object 41
Delete Object 41
Replicate Object 41
Select All Objects 41
Copy Value 41
Replace Value 42
Propagate Attribute 42
Bring Closer 42
Send Further 42
The Tools Menu 42
Find… 43
Set Selection 45
Find Again 46
Replace 46
Replace All 46
Compact 46
Uncompact 48
Make Execute Only 48
The Opers Menu 48
Simple 49
Constant 49
Match 49
Persistent 49
Instance 49
Get 50
Set 50
Local 50
Evaluate 50
Mac Constant 50
Mac Match 50
Mac Global 50
Mac Address 50
Mac Get Field 51
Mac Set Field 51
Opers to Local 51
Local to Method… 51
The Controls Menu 53
Operations 53
Terminals and Roots 54
Controls on Operations and on the Output Bar 54
The Info Menu 55
Display of Information 56
Comment Visibility 64
Comment Propagation 64
Class Hierarchy 64
Errors / Program Correctness / Options 65
The Windows Menu 70
Universal Methods, Classes, Persistents 70
Methods…, Attributes… 70
Local Heritage… 70
Stack 71
Close Window 71
Remember Windows 71
Restore Windows 71
Tidy Icons 71
Add Scroll Page, Remove Scroll Page 72
Window Descriptions 72
The Universal Methods Window 72
Opening 73
Creating 73
Deleting 73
Naming 73
Editing a Method 73
Combinations 73
The Classes Window 74
Opening 74
Creating 74
Showing/Hiding Classes 74
Editing 75
Naming 76
Connecting / Disconnecting 76
Opening Classes 76
Combinations 76
Group Selection 76
The Class Methods Window 77
Opening 77
Creating 77
Deleting 78
Naming 78
Transforming a Class Method 78
Editing a Method 78
Combinations 78
The Attributes Window 79
Opening 79
Attribute List Areas 79
Creating 79
Deleting 80
Editing 80
Naming 80
Commenting 80
Changing Default Values 80
Dragging 80
Combinations 81
Group selection 81
The Persistents Window 81
Opening 81
Creating 81
Naming 81
Changing Values 81
The Case Window 82
Banner 82
Opening 82
Creating 83
Copying 83
Deleting 83
Naming 83
Specifying Execution Order 83
Connecting / Disconnecting 84
Commenting 84
Dragging 84
Transformations 84
Combinations of Creating, Connecting, and Annotating 89
Selection of Element Groups 90
Manipulation of Groups 90
Enforcement of Corresponding Arity 92
Propagation of Comments 92
Opening Operations: The Left and Right “Click Spots” 93
Manipulation of Cases 97
Case Controls 97
Case List Pane 97
Closing Case Windows 98
Value Window 99
Banner 99
Window Regions 99
Opening 100
Modes 100
Editing 101
Effects of Buttons 102
Types 102
The Text Window 102
Opening 102
Naming 102
Editing in the Text Window 103
Effects of Context Switching 103
Chapter 3. The Interpreter Environment 105
Modes of Execution 105
Windows 106
Stack Window 107
Opening 108
Actions 108
Rollback 108
Case Window 109
Opening 109
Actions 109
Displaying Values 110
Opening Value Windows 111
Rollback 112
Roll Forward 114
Effect of Roll Forward and Rollback on the Stack 114
Menus 114
Apple Menu 115
Switch Context 115
Enter Editor 115
Exec Menu 115
Run 116
Execute Method 116
Abort 116
Set Program 117
Clear Program 117
Step/Show Level… 117
Step/Show On, Step/Show Off 118
Breakpoint On 119
Breakpoint Off 119
Clear Steps & Breaks 119
Trace 119
Debug 119
Runtime Interruption 120
Automatic Creation at Runtime 120
Method 120
Attribute 121
Persistents 121
Classes 122
Errors in Execution 122
Apple Events 123
Prograph Interpreter Apple Events 123
Required Suite 123
Miscellaneous Standard Suite 123
Core Suite 123
Do Menu 124
Open Method Window 124
Close Window 124
Chapter 4. Application Builder 125
General Features 125
Specification and WYSIWYG Editors 125
System 7 Look and Feel 127
Applicable Prograph Menus 127
Apple menu 127
About Prograph… 127
Enter Editor 128
Exit Editor 128
Edit menu 128
Info Menu 129
Application Editor 129
Name 130
About Method 130
Classes 130
List of Instances 130
Windows/Menus 130
Library/Active List 131
>>New Instance>> 131
<<Set Defaults<< 131
Install 131
Add to Active List 131
Delete 131
Edit 132
Apple Events 132
Menu Editor 132
Menu 133
Disable Menu 133
Item 133
Method 133
Key 134
Balloon… 134
Insert Before 134
Insert After 134
Delete 134
Instance 134
Disable Item 134
Check 135
Styles 135
Keys 135
Bold, Italic, Underline, Outline, Shadow 135
Shift, Option, Control 135
Window Editors 136
WYSIWYG Window Editor 136
Window Specification Editor 137
Window Title 138
Activate Method, Close Method, Idle Method,
Key Method 138
Document, Dialog, Plain, Plain w/Shadow 138
Close Box 138
Zoom Box 138
Grow Box 139
Modal 139
Window Item Editors 139
WYSIWYG Window Item Editor 139
Window Item 140
Click Item 141
Balloon… 141
Button 142
Radio Set 143
Check Box 143
Graphic 144
Pict 144
Icon 145
Text 146
Edit Text 148
Scroll Text 149
Styled Text in Prograph Classic 149
Scroll List 150
Canvas 151
Balloon Help 153
Balloon Help Editor 154
Access to Events 158
Events in Prograph 158
Apple Events 158
Handling Events Yourself 160
Mouse Techniques 163
INDEX Use Contents Menu or Find *Index* to jump to the Index (last chapter)